LEGION Simulator Help

Track Properties

Each track you place on the Timeline has certain properties which need to be defined correctly in order for playback and recording to occur and for specified events to run successfully. You can access a track’s properties by right-clicking on it and selecting Track properties.

For instance, if you are saving data files (maps, graphs, snapshots, ‘avi’ files or ‘res’ files), you need to define where you want to save the files, what you want to call the files and whether you are saving one file or multiple files.

If these properties are undefined, or defined incorrectly, the track status icon will issue a warning or an error, which will also be visible in the ‘QA’ portion of the Output Bar.

The following procedures describe how to set properties for the various Analysis Timeline tracks.

Parent topic: Adding Tracks to the Timeline

Setting the Maps track properties

Maps track properties require you to define names and locations for any data files you want to save for one or more Save Map events. This procedure assumes that you have the ‘Maps Track Properties’ dialog box open.

To set Maps track properties:

  1. Under ‘File Usage’, select one of the options:
    • Save all data to a single file - select if you only intend to save a single map at one specific time within the simulation. Go to step 2.
    • Save all data to multiple files - select if you intend to save two or more maps at one or several times within the simulation. Go to step 5.
  2. Next to ‘Single File Setup’, click the browse button to display the ‘Save As’ dialog.
  3. Navigate to the location you want to save the file, enter a name for the file and click Save.
  4. Click OK to close the ‘Maps Track Properties’ dialog.
  5. Next to ‘Folder’, click the browse button and either select an existing folder or create a new one. This is where your multiple files will be saved.
  6. From the ‘Templates’ drop-down list, select one of the available combinations of information to be saved as part of your filenames (these include Date, Time, Object Name, Event Name, Model Time, Time). These template elements are added to the ‘Base filename’ box.
    Tip: The ‘Example’ box at the bottom of the dialog shows you how the files will be named.
  7. If you wish to add your own filename prefix, enter it in the ‘Base filename’ box, taking care not to overwrite the template elements which are listed there.

    File iteration separators and numbering style are automatically defined.

  8. Click OK to close the ‘Maps Track Properties’ dialog.

Setting the Graphs track properties

Graphs track properties require you to define names and locations for any data files you want to save for one or more Save Graph events. The procedure is the same as that described in "Setting the Maps track properties" above.

Setting the Screen Camera track properties

Screen Camera track properties require you to define names and locations for any data files you want to save for one or more Snapshot events. The procedure is the same as that described in "Setting the Maps track properties" above.

Setting Track properties for Record .AVI and ‘res’ tracks

The properties of these types of track can be set by following the procedures in Set the Record .RES track properties and Set the Record .AVI track properties .

Setting the Record Entity Positions track properties

Record Entity Positions track properties require you to define names and locations for any XML files you want to save. This procedure assumes that you have the ‘Record Entity Positions Properties’ dialog box open.

To set the Record Entity Positions track properties:

  1. Next to ‘Filename to save to’, click the browse button to display the ‘Save As’ dialog.
  2. Navigate to the location where you would like to save the Entity position file, enter a name, and click Save.
  3. If you want to record Entity positions in a specified area covered by an Analysis Zone, check the box labelled ‘Use region’ and select an area from the drop-down list labelled ‘Analysis Zone’.
  4. If you want to change the default ‘Save frequency’ of 0.6 seconds, enter a new value in the box labelled ‘Save entity positions every n seconds’.
  5. Click OK.

    A new track called (in this case) ‘Record Entity Positions’ is added to the Timeline.

Setting the Save 15-minute Underground Maps track properties

To set track properties:

  1. 1. Right-click on the Save 15-minute Underground maps track and select Track properties.
  2. Under ‘File Usage’, select one of the options:
    • Save all data to a single file - select if you only intend to save a single map at one specific time within the simulation. Go to step 3.
    • Save all data to multiple files - select if you intend to save two or more maps at one or several times within the simulation. Go to step 7.
  3. Under ‘Single File Setup’, click the browse button to display the 'Browse For Folder’ dialog.
  4. Navigate to the location you want to save the file and click OK.
  5. In the field labelled 'File title', enter your preferred name for the file.
  6. Click OK to close the ‘Maps Track Properties’ dialog.
  7. Under ‘Multiple Files Setup’, to display the 'Browse For Folder’ dialog.
  8. Navigate to the location you want to save the file and click OK.
  9. From the ‘Templates’ drop-down list, select one of the available combinations of information to be saved as part of your filenames (these include Date, Time, Object Name, Event Name, Model Time, Time). These template elements are added to the ‘Base filename’ box.
    Tip: The ‘Example’ box at the bottom of the dialog box shows you how the files will be named.
  10. If you wish to add your own filename prefix, enter it in the ‘Base filename’ box, taking care not to overwrite the template elements which are listed there.

    File iteration separators and numbering style are automatically defined.

  11. Click the 'Track info' tab and check or uncheck the box labelled 'Enable this track' to make the track active or inactive.
  12. Click OK to save your changes.

Setting the Save 60-minute Underground Maps track properties

Follow the steps as in "Setting the Save 15-minute Underground Maps track properties", above.